Glossary Item Box

Squirrelcart v2.6.1

Store Settings

The Store Settings page allows you to change many different aspects of your store. This page will give you an overview of each section of the Store Settings page and it's purpose.

 

Opening the Store Settings Page
  1. Open the control panel
  2. Click the Store Settings  icon in the toolbar.
Overview
  1. Company Information
    Squirrelcart uses the information in this section whenever it needs information about your company. This information is used for various features throughout the cart. It is important that you fill this section out as accurately as possible.

  2. Email Settings
    This section controls the emails that Squirrelcart sends.



    General

    Default From Email
    This is the default email address that all your messages will come from, which can be overriden for certain messages using the From Email field for that message.


    Default From Name
    This is the default display name for emails sent from your store. If you leave this blank, your company name will be used.


    Return-Path
    This field is optional. It controls what will be used for the Return-Path email header for all emails sent from your store. If you leave this blank, the value specified in Default From Email will be used. Please note that it is not always possible to set the Return-Path header on all systems. If you've set Default From Email to an address that is not on your domain, you should definitely set this field to an address on your domain or some email providers (AOL especially) will block your messages.


    Default Format
    This field controls the default format for messages sent by your store.

    HTML and text (multi-part): this is the default. It allows you to specify the message in HTML and plain text. Users that have their email clients configured to display HTML will see the HTML email, and users that don't will see the plain text. If the user the message is sent to has their email preference in Squirrelcart set to text, then only the text portion of the email will be sent to them.

    HTML only: only HTML will be sent to the recipients. Keep in mind that choosing this option will send HTML to customers even if their email preference in Squirrelcart is set to text.

    text only: only text will be sent to recipients.



    Email Order to Merchant
    This field controls whether an email will be sent to the merchant after a customer places an order.


    Email Order to Customer

    This field controls whether or not an email order confirmation will be sent to your customer after they place an order.


    Email Ship Notice to Customer
    This field controls whether or not an email will be sent to the customer when a shipment is submitted and assigned to their order.


    Order Notification to Merchant


    To
    This field controls the addresses that the order notification email will be sent to. Separate multiple entries with semicolons. You can choose user accounts and groups using the address book button.


    Subject
    This field controls the subject of the email sent. Any field from the order can be added via a variable like these examples:

         Order #<?=$Order_Number?> Notification
         Order #<?=$Order_Number?> - <?=$Order_Date?>

    The variables represent fields in the Orders table, and must be preceded with "Order_" in order to work.


    From
    This field controls the email address and name the email will appear to come from. The default is "customer", which will use the customer's email address and name and allow you to reply to the customer when you click "reply" in your email client. If you change this to "other", 2 additional fields will appear for you to specify an email address and name.


    Format
    This field controls the format of the message.

    default: This uses the value specified in Default Format

    HTML and text (multi-part): see the description for the Default Format field above
    HTML only: see the description for the Default Format field above
    text only: see the description for the Default Format field above


    Email Credit Card Number
    When checked, Squirrelcart will include the customer's credit card number in the order email sent to the merchant. This should not be enabled under normal circumstances, as it is not secure. This feature is explained in further detail in the payment section of the documentation.


    Transpose Number
    This field is only displayed when Email Credit Card Number is checked. This number is added to the credit card number before it is entered into the order email sent to the merchant.



    Order Confirmation to Customer

    Subject
    This field controls the subject of the email sent. Any field from the order can be added via a variable like these examples:

         Order #<?=$Order_Number?> Notification
         Order #<?=$Order_Number?> - <?=$Order_Date?>


    The variables represent fields in the Orders table, and must be preceded with "Order_" in order to work.


    From Email
    This field controls the email address this email will come from. If left blank, the value for Default From Email is used.


    From Name
    This field controls the name this email will come from. If left blank, the value of Default From Name is used. If that field is blank, your Company Name is used.

    Format
    This field controls the format of the message.

    default: This uses the value specified in Default Format

    HTML and text (multi-part): see the description for the Default Format field above
    HTML only: see the description for the Default Format field above
    text only: see the description for the Default Format field above


    Ship Notification to Customer

    Subject
    This field controls the subject of the email sent. Any field from the shipment or order record can be added via variables like these examples:

         Order #<?=$Order_Number?> shipped
         Shipment notice: <?=$Shipment_Tracking_Number?>

    The variables represent fields in the Orders and Shipments table, and must be preceded with "Order_" or "Shipment_" in order to work.


    From Email
    This field controls the email address this email will come from. If left blank, the value for Default From Email is used.


    From Name
    This field controls the name this email will come from. If left blank, the value of Default From Name is used. If that field is blank, your Company Name is used.


    Format
    This field controls the format of the message.

    default: This uses the value specified in Default Format

    HTML and text (multi-part): see the description for the Default Format field above
    HTML only: see the description for the Default Format field above
    text only: see the description for the Default Format field above



    Forgotten Password

    Subject
    This field controls the subject of the email sent. You cannot use variables in this field.


    From Email
    This field controls the email address this email will come from. If left blank, the value for Default From Email is used.


    From Name
    This field controls the name this email will come from. If left blank, the value of Default From Name is used. If that field is blank, your Company Name is used.


    Format
    This field controls the format of the message.

    default: This uses the value specified in Default Format

    HTML and text (multi-part): see the description for the Default Format field above
    HTML only: see the description for the Default Format field above
    text only: see the description for the Default Format field above

  3. Security Settings


    Check Referrer
    This field determines whether or not Squirrelcart will check the referring URL when someone attempts to post data to the cart.

    Authorized Hosts
    Set value equal to a list of all authorized host names that can submit data (add items to cart, etc). Separate each hostname with a new line. If left blank, authorized hosts will default to what you specify as your www_root and secure_root in the config file.

    When Referrer is Blank
    Some browsers do not send a referrer. This field determines whether the cart will allow the form submission when a referrer is not sent with the request. Set to "allow" to allow the submission, and set to "deny" to block it.

    Restricted Usernames
    This field is used to prevent customers from creating user accounts with certain names. List each username you want to restrict on a separate line.


    Min Username Length
    Minimum length for a username.


    Min Password Length
    Minimum length for a password


    Forgotten Password Limit
    Set value equal to the number of times you want someone to be able to submit the forgotten password form, in an attempt to be emailed a new password. if you leave it blank, the value will default to 8.


    Session Timeout
    The value for this field should be a number equaling the amount of minutes a customer can be idle before their cart is abandoned. This number is also the amount of time that the cart will wait before restocking items that where added to a cart but never purchased. This only happens when "Use Inventory Control" is enabled. The default value for this field is 180.


    Referrer Cookie Expiration
    This field controls the length in days that the referrer cookie will be valid. This cookie is set to store the originating referral address that a customer used to visit your site. Storing this in a cookie allows Squirrelcart to retrieve it on subsequent visits to your site.


    Use Remember Me
    When checked, the "Remember Me" feature is enabled. This allows users to check the Remember Me checkbox at login, which will then automatically log them in on their subsequent visits.


    Remember Me Expiration
    The length in days that Squirrelcart should wait before expiring "remember me" information. After this number of days has past, the cookie that allows the user to be automatically logged in is no longer valid.


    Remember Me Default
    This field controls the default value of the "Remember Me" checkbox on the login form.


    Collect CVV2/CVC
    If checked, the cart will prompt the customer for their CVV2/CVC code.


    CVV2/CVC is Required
    This forces the customer to enter their CVV2/CVC code in order to submit an order.
  4. Inventory Control
    This section is for the inventory control feature, which allows you to track the number of units you have in stock for each product in your database. Inventory Control has it's own section in the documentation.

  5. General Settings


    Weight Units
    This defines the units that are used for weight fields.


    Dimension Units
    This defines the units that are used for dimensional fields (width, height, depth).


    Order Number Format
    This field controls the format of your order numbers. Default value for this field is "Random". When set to "Random", the cart uses the Unix timestamp at the time of the order. When set to "Custom", the cart uses the value of the "Next Order Number" field, and increments the order numbers by the value of the "Increment by" field.

    Per Order Handling Fee
    This field is used to apply a handling fee to the entire order.

    Minimum Order Amount
    This field is used to enforce a minimum order total (before shipping, handling, and taxes).

    Maximum Quantity
    The default for this field is 1,000. Leave blank to accept the default. This field controls the maximum quantity allowed for a single item when it is added to the cart. The main purpose of this setting is to avoid ridiculous orders for millions of items, which could potentially cause problems with payment systems.
     
    Important Note: Do not include commas in your value!!!


    Add to Cart Behavior
    This field determines what will happen after a customer adds an item to the cart. If "go to checkout" is selected, than when you add an item to the cart, the customer will be taken to the checkout page. If "stay on product page" is selected, the customer will stay on the same page as from which they added the item to the cart, and they will get a message at the top of the page indicating that the item was added.


    Checkout Login Behavior
    This field determines what will happen after a customer logs in while checking out. If "show address form" is selected, the address form will be shown, populated with the information from the user's account. If "show cart" is selected, checkout form will be shown, along with the customer's address information above in small boxes.


    Diagnostic Mode
    When this field is checked and you are logged in as a member of the "Store Admin" group, Squirrelcart will output diagnostic information to the browser during certain operations. This is useful for troubleshooting communications via CURL and other complex operations. See the Diagnostic Mode topic for more information.


    Force User Creation
    This field defaults to disabled. If enabled, when a customer checks out, and is not already logged in, they will be presented with the "New Account Form". This makes user creation mandatory for a purchase.

    DB Version
    This field is read only, and displays the version number for your database, which should match the version number of your files in the top right corner of the page.
  6. Search Engine Settings
    This section is used to control aspects specific to search engines. This is described in detail in the Search Engine Settings topic.
  7. Discount Settings


    Disable Coupon Codes
    This field is used to stop the coupon code form from showing up at checkout.


    Coupon Code Case
    This field controls whether or not the coupon codes entered by your customers will be case sensitive. The default is case insensitive.
  8. Quantity Based Discount Settings

    This section is used to control quantity based discounts for regular customers (non group members). This is described in detail in the "Managing Your Store > Quantity Based Discounts" section of this documentation.

    quantity based discount settings
  9. Control Panel


    Use SSL
    Checking this box enables secure access to your control panel via SSL, provided that you specified a secure URL in your config file for the $site_secure_root variable.

    Use Version Control
    Enables or disables the use of Version Control. When enabled, your installation of Squirrelcart will compare the installed version to that of the most recent available, and indicate if an update is available.


    Delete Unused Images
    By default, this field is checked. When checked, the cart will:

           Delete images associated with Products, Categories, and Product Options when the record using them is also deleted
           Delete images associated with Products, Categories, and Product Options when a new image is uploaded, and the original image is no longer associated with any other records
     
    If you uncheck this field, the cart will not delete unused images.


    Records per Page
    Set value equal to the number of records you want to display on a single page in the admin section.


    Images in Data Rows
    This field controls whether or not you want certain images to appear in the data grid that is used to navigate through your records. To enable, check the box, to disable, uncheck it. An example of this is the display of the thumbnail images when viewing product records.


    Rich Text Word Wrap
    This setting controls whether the code tab in the rich text editor will have word wrap enabled or disabled. To enable, check this field.


    Rich Text Cleanup 
    This setting controls whether the code generated by the Rich Text editor will be cleaned up using HTML Tidy. Cleaning up the HTML generated by the editor will make it standards compliant. This requires the html tidy module, and PHP v4.3 or newer.
  10. PHP Extensions


    Some of the advanced features of Squirrelcart require certain PHP Extensions to function. This section controls whether or not the cart will attempt to load an extension dynamically, if it is not already loaded with PHP.
    If an extension is checked, and it is not already loaded, Squirrelcart will try to load it. We recommend that you do not modify this section under normal circumstances.

 

 


© 2001-2008 Lighthouse Development. All Rights Reserved. Copy and Print Shops - please note: this is documentation and may be printed by anyone without violating our copyrights.